|
|
InsXTime |
||||
| Header: | Timer.h | Carbon status: | Modified | |
Installs a task, taking advantage of the drift-free, fixed-frequency timing services of the extended Time Manager.
void InsXTime (
QElemPtr tmTaskPtr
);
A pointer to an extended task structure to be installed in the queue.
The InsXTime function adds the Time Manager task structure specified by tmTaskPtr to the Time Manager queue. Use InsXTime only if you wish to use the drift-free, fixed-frequency timing services of the extended Time Manager; use InsTime in all other cases. The tmTaskPtr parameter must point to an extended Time Manager task structure. Your application must fill in the tmAddr field of that task. You should set the tmWakeUp and tmReserved fields to 0 the first time you call InsXTime.
With the extended Time Manager, you can set tmAddr to NULL if you do not want a task to execute when the delay passed to PrimeTime expires. Also, InsXTime resets the high-order bit of the qType field to 0.
Modified in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
The interface for Time Manager callbacks will change, because the task record is currently available only from 68k code.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)